home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / win_utl2 / oh2b30d.zip / OH1TO2.TXT < prev    next >
Text File  |  1996-04-04  |  9KB  |  185 lines
  1.                       Copyright 1996, Hyperion Softword
  2.  
  3.                     *************************************
  4.                     *  Orpheus 2, beta release 2.00.30  *
  5.                     *************************************
  6.  
  7.                 Comments and queries to:  Hyperion Softword,
  8.                 535 Duvernay, Sherbrooke, QC J1L 1Y8, Canada
  9.                     tel/fax - 819-566-6296 (Rod Willmot)
  10.                        email - willmot@interlinx.qc.ca
  11.  
  12.  
  13. Contents of this file:  Purpose
  14.                         Usage
  15.                         Registered Users
  16.                         Disk Space Requirements
  17.                         Step 1: The Converter
  18.                         For More - See Online Help
  19.  
  20. PURPOSE:
  21. ========
  22.  
  23.     OH1TO2.EXE (The Converter) is a utility for converting Orpheus 1.nn
  24.     files to the Orpheus 2 standard.  Projects to be converted must be in
  25.     uncompiled format, not HTX's.  OH1TO2 does not delete or overwrite the
  26.     original project.  You should not dispose of the original until you are
  27.     fully satisfied with your results using Orpheus 2.
  28.  
  29.  
  30. USAGE:
  31. ======
  32.  
  33.     Give the following command at the DOS prompt:
  34.  
  35.         OH1TO2
  36.  
  37.     The Converter will take over from there, asking what you want to
  38.     convert and where you want the new version to go.  It's safe, easy
  39.     to use, and interactive.  As discussed later on this document, it
  40.     even lets you pause during conversion to free up disk space.
  41.  
  42.  
  43. REGISTERED USERS:
  44. =================
  45.  
  46.     If you are a registered user of Orpheus 1 (any version), and are
  47.     using a copy of Orpheus 2 received from any shareware source (BBS,
  48.     Internet archive, CD-ROM, etc), please note that you must obtain
  49.     a KEY file from Hyperion Softword in order for Orpheus 2 to recognize
  50.     you as a registered user.  Until you do so, anything you compile
  51.     with the new version will invoke the "unregistered shareware" warning
  52.     from the Reader.
  53.  
  54.     Users who purchased Orpheus 1.64-1.65 at the full price ($79 *US*)
  55.     will receive a complete upgrade package, including KEY file, when
  56.     Orpheus 2 is officially ready.  If you're happy with Orpheus 2 even
  57.     in beta form and want your KEY file as quickly as possible, give me
  58.     a voice call at 819-566-6296 and we'll arrange for you to download 
  59.     it directly from me.  Or I can email it to you as a file attachment.
  60.  
  61.     Users who purchased earlier versions of Orpheus, or who paid less
  62.     than the current price in US dollars, will receive an upgrade offer
  63.     in the mail.  Again, if you're in a hurry just give me a call.
  64.  
  65.  
  66. DISK SPACE REQUIREMENTS:
  67. ========================
  68.  
  69.     The Converter does not delete or overwrite any of the files from the
  70.     original version of a project.  The converted (Orpheus 2) version is
  71.     stored in a different set of directories.  This means that if you
  72.     have an enormous project to convert, and little free disk space,
  73.     you will need to free up space either before or during the conversion
  74.     process.  Don't panic.  Read on.  This is a friendly Converter.
  75.  
  76.     If you NEED to free up space and are not using a disk-compression system
  77.     such as Stacker or Doublespace, you will have to offload files onto
  78.     diskette.  If you are not using a disk-compression system, a better
  79.     method is to compress rarely-used files with PKZIP.  Actually the best
  80.     method in both cases is to do a little house-cleaning... I've never seen
  81.     a file that didn't beg to be deleted.  (We're lean and mean, here at
  82.     Hyperion Softword.)
  83.  
  84.     Once you have told the Converter what you want to convert, and where
  85.     you want it to store the new version, the program analyzes the original
  86.     project and estimates how much disk space it will need.  As conversion
  87.     proceeds you can watch the indicators showing remaining free space and
  88.     space still needed.  At any time, you can interrupt processing by
  89.     pressing the <Spacebar>.  This opens the "OH1to2 paused" dialog,
  90.     which has three options:  press the <Spacebar> again to resume, press
  91.     <Esc> to abort conversion, or press <Alt-S> to shell to DOS.
  92.  
  93.     Use this last option (shelling to DOS) to offload files onto diskette or
  94.     compress files with PKZIP, assuming you need to free up space.  When you
  95.     return from the shell by giving the "exit" command at the DOS prompt,
  96.     you'll be back in the "OH1to2 paused" dialog and can resume processing,
  97.     abort processing, or even shell to DOS again.  It's neat shelling out
  98.     without spending a dime.
  99.  
  100.  
  101. STEP 1: THE CONVERTER:
  102. ======================
  103.  
  104.     The first step is to run OH1TO2 on the project you want to convert.
  105.     When you start the program the opening dialog asks for the following
  106.     input:
  107.  
  108.          Old Project:
  109.          [............................................................]
  110.  
  111.          New Name:
  112.          [........]
  113.  
  114.          New Path:
  115.          [............................................................]
  116.  
  117.     In the "Old Project" field, enter the full path to the project you
  118.     wish to convert, ending with the name of the project itself.  For
  119.     example, if you have a TEST project based in the C:\ORPHEUS\
  120.     directory, enter "C:\ORPHEUS\TEST".
  121.  
  122.     In the "New Name" field, enter the name you wish to use for the
  123.     Orpheus 2 version of the project.  It can be the same as the original
  124.     if you wish, but you might prefer a different name to avoid confusion,
  125.     such as TEST2 if the original was TEST.  The name can be up to 8
  126.     characters long; it cannot include a path or file extension.
  127.  
  128.     In the "New Path" field, enter the full path to where you want the
  129.     converter to store the Orpheus 2 version of the project.  This MUST be
  130.     a different from the location of the original version.  If any directories
  131.     named in the path do not exist, the Converter will create them.  For
  132.     example, suppose you are using C:\OH2 as your directory for your Orpheus 2
  133.     program files.  You can also use this as the base directory for your
  134.     converted projects.  In this case you would enter "C:\OH2" -- just the
  135.     path, not the name of the project itself.
  136.  
  137.     ->> In Orpheus 2, project directory names are identical to the project
  138.     name itself; they do not end with an underscore as in Orpheus 1.  For
  139.     example, the TEST project under Orpheus 1 would have a project directory
  140.     named TEST_, but under Orpheus 2 it would just be TEST.  Following our
  141.     example, using TEST2 as the new name would result in a project directory
  142.     named C:\OH2\TEST2\.  The new project file, TEST2.PRJ, would be stored
  143.     in C:\OH2\.
  144.  
  145.     Once you've filled the Old Project, New Name, and New Path fields to
  146.     your satisfaction, tab to the "Begin Conversion" command and press <Enter>.
  147.     The Converter makes sure everything seems right before going on.
  148.  
  149.     The next stage begins with a scan of your old project.  The Converter
  150.     examines every storage directory in it, counting up how many cards you
  151.     have.  Then it displays an estimate of the amount of disk space needed
  152.     along with the disk space currently free.  Since OH1TO2 does *not*
  153.     delete or overwrite your old project's files, the free space will
  154.     diminish as conversion proceeds.  As discussed above under "Disk Space
  155.     Requirements", you can pause conversion at any time, then either abort
  156.     or shell to DOS in order to free up more space.
  157.  
  158.     When the conversion is complete, you may see a message warning you
  159.     about script commands requiring further updating on your part.  This
  160.     is discussed later on under "Updating Script Commands".
  161.  
  162.  
  163. FOR MORE - SEE ONLINE HELP
  164. ==========================
  165.  
  166.     Complete documentation on using the Converter, and on other important
  167.     aspects of moving up to Orpheus 2, is available in online help.  While
  168.     in OH.EXE, press <F1> to open Help, and from the Contents page select 
  169.     "Orpheus Utilities->OH1TO2.EXE->Documentation".  Everything in this
  170.     file is included, along with the following additional topics:
  171.  
  172.         Results of Step 1
  173.         What Got Changed
  174.         Step 2: You and OH.EXE
  175.         The Reader Interface
  176.         The Resource Path
  177.         Concatenating "More" Links
  178.         Updating Script Commands
  179.  
  180.     Since the Help version includes hypertext links to everything in the
  181.     Orpheus system, and since you may be doing further conversion while
  182.     working in OH.EXE, you will find that much easier to use than this
  183.     file.  You can even print out hard copy from Help.
  184.  
  185.